home *** CD-ROM | disk | FTP | other *** search
/ Best of Mega Graphics Pack / Best of Mega Graphics Pack.iso / win_kudo / kudoini.txt < prev    next >
Text File  |  1996-03-05  |  8KB  |  169 lines
  1.  
  2.                       Kudo for Windows TechNote
  3.                    (c) 1993 Imspace Systems Corporation.
  4.                             All Rights Reserved.
  5.  
  6.  
  7. This file documents the structure and syntax of the KUDO.INI file.
  8. The KUDO.INI file follows the standard Windows syntax for all .INI files.
  9.  
  10.  
  11. ******************************************************************************
  12. These are the sections in KUDO.INI and their function:
  13.  
  14. [KudoImageBrowserImports]       Associates a file extension with a filter DLL
  15. [KudoPlacePacks]                Associates an application with a place module
  16. [OLEDropTargets]                Identifies a registered OLE 2.0 drop target
  17.  
  18. Each of these sections can have zero or more entries following the section 
  19. header.
  20.  
  21. ******************************************************************************
  22. [KudoImageBrowserImports]
  23. -------------------------
  24. The entries in this section list all of the file types that Kudo can recognize.  
  25. This feature is provided to enable users to add more import filters & file types,
  26. and redefine what file extensions Kudo uses to recognize each file type.
  27.  
  28. To read image and multimedia files of different formats, Kudo uses a modular 
  29. system based on the industry standard Aldus filter specification.  This system 
  30. allocates a specific external Dynamic Link Library file (a .DLL file) for each 
  31. file type to be recognized.  These DLL's are known as import filters, or 
  32. filters.
  33.  
  34. Kudo uses a file's extension to identify what type of file it is, and 
  35. consequently, which filter DLL to load in order to read that file.  The 
  36. [KudoImageBrowserImports] section  of KUDO.INI tells Kudo 1) what file 
  37. extension represents a particular file format, and 2) which filter to load in 
  38. order to read that file.
  39.  
  40. The syntax of one of these entries is:
  41.  
  42.         <description>=<path>,<extension>
  43.  
  44. where
  45.         <description>:  Cosmetic text that describes the particular file type
  46.         <path>:         Path (full or relative) to the .FLT or .DLL file
  47.                         that functions as the import filter for this file
  48.                         type.  This is a regular DOS pathname.  If it is not a
  49.                         fully qualified path, it is interpreted as relative to
  50.                         the directory where the currently executing copy of
  51.                         KUDO.EXE was found.
  52.         <extension>:    1-4 character text specifying the file extension to
  53.                         associate with this file type.  The dot '.' is
  54.                         optional.
  55.  
  56. There should be no spaces around the equal sign ('=') or comma (','). For 
  57. example, the following entry:
  58.  
  59.         [KudoImageBrowserImports]
  60.         ZSoft PC Paintbrush Bitmap=filters\IRPCX9.FLT,PCX
  61.  
  62. would be interpreted as follows:
  63.  
  64.         <description>: "ZSoft PC Paintbrush Bitmap"
  65.         <path>: "filters\IRPCX9.FLT"
  66.         <extension>: "PCX"
  67.  
  68. This entry tells Kudo that 1) files with a .PCX extension are "ZSoft PC 
  69. Paintbrush Bitmap" files, and 2) the filter file "filters\IRPCX9.FLT" is the 
  70. filter DLL to load when trying to read these files.
  71.  
  72. For readability, the entries in the default KUDO.INI also include the file 
  73. extension at the beginning of the <description> field, but this is cosmetic - 
  74. only the <extension> field is actually used to determine the file extension.
  75.  
  76. The same filter DLL can be specified in more than one entry.  This way it is 
  77. possible to alias several file extensions as the same file type.  For example, 
  78. the Micrographix Drawing File Format is listed twice in the default KUDO.INI 
  79. file, for both the .DRW and .GRF file extensions.  However, you can only
  80. have one entry for each file extension.  For example, you cannot have two
  81. lines specifying .PCX as the file extension.
  82.  
  83. By convention, the filter DLL's that are shipped with kudo bear the file 
  84. extension .FLT, but they can have any file extension.  It is recommended that 
  85. abide by this convention and use a .FLT or .DLL extension.
  86.  
  87. New file types can be added to Kudo simply by modifying KUDO.INI.  Any DLL 
  88. that implements the Aldus Graphic Import Mechanism, either Interface Version 
  89. 1.0 or 2.0, can be listed as an import filter in the [KudoImageBrowserImports] 
  90. section.  This interface is documented in the Aldus "Filter Developer's 
  91. Toolkit", published by Aldus Corporation. For questions about the Aldus 
  92. standard, you can contact them at:
  93.  
  94.         Aldus Developers Desk
  95.         Aldus Corporation
  96.         411 First Avenue South
  97.         Seattle, WA  98104-2871
  98.         206/628-6593
  99.  
  100.  
  101.  
  102. ******************************************************************************
  103. [KudoPlacePacks]
  104. ----------------
  105. This section lists each of the available place modules. These Place Modules 
  106. are provided to enable Kudo to Drag and Drop with pinpoint accuracy onto 
  107. applications that fall into one or more of the following three categories: 
  108. 1) applications that are not registered as OLE 2.0 drop targets in the 
  109. [OLEDropTargets] section (see below), 2) applications that do not accept an 
  110. image file drop from the File Manager, or 3) applications that require special 
  111. handling for a drop.
  112.  
  113. Kudo uses an application's window caption to identify it, and consequently, 
  114. match it with the appropriate place module, if it exists. The [KudoPlacePacks] 
  115. section  of KUDO.INI tells Kudo 1) which applications have place modules, and 2) 
  116. which place modules to load in order to drag and drop to that application.
  117.  
  118. The syntax of one of these entries is:
  119.  
  120.         <application name>=<path>,
  121.  
  122. where
  123.         <description>:  The application caption as it appears on the title bar
  124.         <path>:         Path (full or relative) to the .DLL file that functions 
  125.                         as place module for this application. This is a regular 
  126.                         DOS pathname.  If it is not a fully qualified path, it 
  127.                         is interpreted as relative to the directory where the 
  128.                         currently executing copy of KUDO.EXE was found.
  129.  
  130.  
  131. As in the [KudoImageBrowserImports] section described above, there should be 
  132. no spaces around the equal sign ('=') or comma (','). The ending comma is 
  133. required even if there is no accompanying comment.
  134.  
  135.  
  136. ******************************************************************************
  137. [OLEDropTargets]
  138. ----------------
  139. This section identifies applications which have implemented an OLE 2.0 drop 
  140. target interface and have been tested as drop targets with Kudo. 
  141.  
  142. Kudo uses an application's window caption to identify it, and consequently, 
  143. match it with the appropriate data transfer object module. The [OLEDropTargets] 
  144. section  of KUDO.INI tells Kudo 1) which applications are OLE 2.0 drop targets, 
  145. and 2) which data transfer object to load in order to drag and drop to that 
  146. application.
  147.  
  148. The syntax of one of these entries is:
  149.  
  150.         <application name>=<path>,
  151.  
  152. where
  153.         <description>:  The application caption as it appears on the title bar
  154.         <path>:         Path (full or relative) to the .DLL file that functions 
  155.                         as the data transfer object module for this application. 
  156.             This is a regular DOS pathname. If it is not a fully 
  157.                         qualified path, it is interpreted as relative to the 
  158.                         directory where the currently executing copy of KUDO.EXE 
  159.                         was found. By default, this data transfer object is 
  160.                         mdataxfr.dll.
  161.  
  162.  
  163. As in the [KudoImageBrowserImports] section described above, there should be 
  164. no spaces around the equal sign ('=') or comma (','). The ending comma is 
  165. required even if there is no accompanying comment.
  166.  
  167.  
  168.  
  169.